home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / uncolor.zip / UNCOLOR.DOC < prev    next >
Text File  |  1992-04-26  |  3KB  |  66 lines
  1.  
  2.                                  UNCOLOR
  3.                  Conversion utility to remove Wildcat! 3.x
  4.                      @xx@ color codes from a text file.
  5.    
  6.                                Version 1.01
  7.                            by  Michael A. Conley    
  8.  
  9.                           Compile date:   4/26/92
  10.  
  11.     UNCOLOR is a utility designed to uncolor Wildcat! 3.xx compatible
  12. display files.  It will not touch Wildcat!'s other @-codes, but will
  13. remove any @xx@-style color codes in the valid range @00@ thru @FF@.
  14.  
  15.     UNCOLOR will read your existing files, search for those codes, and
  16. remove them.  The original files will be preserved, with the last character
  17. of the file extension changed to a Tilde (~).   
  18.  
  19. USING THE PROGRAM:
  20. ==================
  21. Use of UNCOLOR is rather straightforward ... it's command line driven as
  22. follows:
  23.  
  24. UNCOLOR with no command line argument will attempt to uncolor all .BBS, 
  25. .SCR, and .HLP files in the CURRENT directory, with the sole exception 
  26. of CONFIGWC.BBS. (in case it's left over from your WC 2.x days.)
  27.  
  28. UNCOLOR followed by a DOS filename or wildcard argument will attempt to 
  29. convert all matching files, excluding several probable non-text filetypes 
  30. such as .COM, .EXE, .OVR, and several others.
  31.  
  32. The original file will be renamed, with the trailing character of the file
  33. extension converted to a tilde (~) ... and the new file will be written
  34. with the file's original name.
  35.  
  36. Read-only or other restricted files will cause the program to prompt the
  37. user whether to continue.  If so, the attributes of the file will be
  38. changed to read-write, and the operation will continue.  Any files whose
  39. backup name already exists in the current directory will cause the program
  40. to prompt the user whether to delete the previous backup.
  41.  
  42. Files with a tilde as the last character of the filename will be rejected 
  43. because of the conflict with the program's renaming pattern.
  44.  
  45. PROBLEMS, QUESTIONS, SUGGESTIONS:
  46. =================================
  47. UNCOLOR is public domain.  I don't seek or accept any registration fees for 
  48. this or any of my other public domain utility programs, including those for
  49. Wildcat! BBS systems.  If you're interested in making a charitable contribu-
  50. tion to express your appreciation, please read the enclosed file SHARE for
  51. my thoughts on the subject.
  52.  
  53. I welcome suggestions, and will try to help (no guarantees) if there are
  54. problems.  You may contact me at The Charlatan's Cabin BBS  (213) 654-7337, 
  55. or via CompuServe (70250,220).
  56.  
  57. If you're a registered Wildcat! SysOp, please leave me a private comment on
  58. the BBS including your Wildcat! registration number, and I'll upgrade you to
  59. member level.
  60.  
  61. ============================================================================
  62. Revision history:
  63.  
  64. 1.00   Compiled 4/25/92     First public release of UNCOLOR.
  65. 1.01   Compiled 4/26/92     Bug fix -- improved directory parsing.
  66.